home *** CD-ROM | disk | FTP | other *** search
/ 17 Bit Software 3: The Continuation / 17-Bit_The_Continuation_Disc.iso / arug / arug 14 / documents / startup.doc < prev    next >
Text File  |  1994-01-27  |  9KB  |  240 lines
  1. The AVT program offers a variety of startup options that may be utilized
  2. either from the WorkBench or the CLI.
  3.  
  4. Before we get to these, we should point out one of the programs
  5. contained in the tools drawer:
  6.  
  7. NextScreen
  8.  
  9. This is an EXTERMELY useful program to have running in your system while
  10. using the AVT system - or any other software, for that matter. It changes
  11. the function of the Left-Amiga-M key such that the NEXT screen is brought
  12. to the rear, instead of the active screen. This is very important in the
  13. AVT system, because there may be as many as 3 screens active just from
  14. the AVT program itself... then there's the workbench, and what if you
  15. have a graphics screen up? Trust us - you NEED this utility!
  16.  
  17. To use it, under 1.2, you'll also need the program 'runback', also in 
  18. the tools drawer. Put them both in your c: directory, and place this line
  19. in your startup-sequence file:
  20.  
  21. runback c:nextscreen
  22.  
  23. To use it under 1.3, just place the nextscreen program in your
  24. c: directory, and put this line in your startup-sequence:
  25.  
  26. run >nil: nextscreen
  27.  
  28. Now, on to the program options:
  29.  
  30. You can always get a list of these options when you are in the CLI mode
  31. by typing:
  33. HAM ? <cr>
  35. Which produces this list:
  36.  
  37.  
  39. program options:  []=option  <>=required
  40. ham [path <sstv:raw/path>] [ipath <SSTV:iff/path>] [fpath <FAX:iff/path>]
  41.     [mem <1-16>] [version] [4meg] [chip] [?] [trim <value>] [ypo <height>]
  42.  
  43. Option format for WorkBench tooltypes use:
  44.  
  45. PARMS=[chip]|[4meg]|[version]
  46.  PATH=path:to/save/sstv/files/in
  47. IPATH=path:to/save/SSTV_HAM/iff/files/in
  48. FPATH=path:to/save/FAX_hi-res/iff/files/in
  49.  TRIM=value  ( -255 -> +255 )
  50.   MEM=value  (    1 ->   16 )
  51.   YPO=value  (  200 ->  240 )
  53.  
  54. The notation used for the CLI options  ( [], <> ) is defined as follows:
  55. a term surrounded by the square brackets is an option, plain and simple.
  56. You can use it or not, as you see fit according to your needs. The
  57. [version] term is an example of this.
  58.  
  59. A term surrounded by the angle brackets MUST be included. In this version
  60. of the program, only terms that go along with options are absolutely
  61. required. For instance, the term [mem] is an option - but if you look at
  62. the list of options printed by the program, you will see that it isn't
  63. written that way - it's written: " [mem <1-16>] ", which means this:
  64.  
  65. You can type "mem" or not, as you choose. But if you DO choose to type
  66. mem, you MUST supply a number from 1 to 16 to go along with it.
  67.  
  68. In the future, if there is a required parameter, it will be in the
  69. option list as " <option> " without and square brackets surrounding
  70. it.
  71.  
  72.  
  73.  
  74.  
  75. Here are the details on the specific options available:
  76.  
  77.         CLI:  [path <sstv:raw/path>]
  78.         WB:   PATH=sstv:raw/path
  79.         
  80.         If you type:
  81.         
  82.         ham path piclib <cr>
  83.         
  84.         The program will look for "raw" sstv files in a directory called
  85.         "piclib" - and it will expect to find that directory in the
  86.         current directory. If you type:
  87.         
  88.         ham path df1:piclib <cr>
  89.         
  90.         It will expect to find the "piclib" directory on the DF1: drive.
  91.         
  92.         
  93.         
  94.         
  95.         CLI:  [ipath <SSTV:iff/path>]
  96.         WB:   IPATH=SSTV:iff/path
  97.         
  98.         If you type:
  99.         
  100.         ham ipath ifflib <cr>
  101.         
  102.         The program will save "IFF" sstv files in a directory called
  103.         "ifflib" - and it will expect to find that directory in the
  104.         current directory. If you type:
  105.         
  106.         ham path df1:ifflib <cr>
  107.         
  108.         It will expect to find the "ifflib" directory on the DF1: drive.
  109.         
  110.  
  111.  
  112.         CLI:  [fpath <FAX:iff/path>]
  113.         WB:   FPATH=FAX:iff/path
  114.         
  115.         If you type:
  116.         
  117.         ham ipath ifflib <cr>
  118.         
  119.         The program will save "IFF" facsimile files in a directory called
  120.         "ifflib" - and it will expect to find that directory in the
  121.         current directory. If you type:
  122.         
  123.         ham path df1:ifflib <cr>
  124.         
  125.         It will expect to find the "ifflib" directory on the DF1: drive.
  126.         
  127.         
  128.         CLI:  [mem <1-16>]
  129.         WB:   MEM=1
  130.          
  131.         If you type:
  132.         
  133.         ham mem 2 <cr>
  134.         
  135.         The program will attempt to allocate memory for TWO full function
  136.         SSTV image memories. If there is not enough memory, you will only
  137.         get one; likewise, if you typed:
  138.         
  139.         ham mem 16 <cr>
  140.         
  141.         and there was not enough memory for 16 image buffers, you would only
  142.         get as many as there was memory for. It takes 192k per image
  143.         buffer - so for all sixteen, you need just over 3 megabytes of memory
  144.         on top of what the program itself requires.
  145.         
  146.         
  147.         CLI: [version]
  148.         WB:  PARMS=version
  149.         
  150.         This option acts differently in the CLI than it does in the WB
  151.         startup. In the CLI, if you include this in the command line, the
  152.         program will print the verison number and then immediately terminate.
  153.         
  154.         If the version keyword is used in the ToolTypes in the ICON for
  155.         the WB startup, the program will print the version in the small
  156.         window it opens on the WB and then start normally.
  157.         
  158.         Use this option when writing us in reference to any aspect of the
  159.         system's performance - we need it to understand the situation
  160.         fully.
  161.         
  162.         CLI:  4meg
  163.         WB:   PARMS=4meg
  164.         
  165.         This option is to be used ONLY if you have a 4 mhz crystal in the
  166.         AVT interface. You should NOT have such a crystal; production versions
  167.         of the AVT are all shipped with a 4.194304 Mhz crystal installed.
  168.         
  169.         This option was required during development for technical reasons,
  170.         and remains for the same reasons. This is not for use by the
  171.         normal user - only for those in the Beta test program.
  172.         
  173.         CLI:  [chip}
  174.         WB:   PARMS=chip
  175.         
  176.         This option MUST be used by those who have Amiga 500's or 2000's
  177.         with only 1 megabyte of RAM. This option enables special screen
  178.         managment routines within the AVT software, without which many
  179.         of the SSTV and FAX modes will not function properly.
  180.         
  181.         The specific problem that the "chip" option was developed to address
  182.         is that of DMA contention between the Amiga's screen display
  183.         hardware and the CPU in a machine that has no memory that is
  184.         devoted to the CPU only (this is called "fast" memory in Amiga
  185.         terms). During receive situations, when the program is invoked with
  186.         the chip option, A "ghost" screen that is a black and white screen
  187.         is brought to the front. This is not a HAM (Hold-and modify) screen,
  188.         but a standard Amiga color register-based screen. These special
  189.         screen manipulations ensure that the CPU has full access to the
  190.         system's memeory, and so has enough "horsepower" to handle the
  191.         data that is coming in at an extremely high rate of speed from
  192.         the receive interface.
  193.         
  194.         CLI:  [trim <value>]
  195.         WB:   TRIM=value
  196.         
  197.         This option is also a development option; it "tunes" the receive
  198.         interface parameters by writing data to the PALS on the AVT
  199.         interface board. This has the effect of shifting the grey levels
  200.         (or in the case of Robot color, the tint).
  201.         
  202.         The default from either the CLI or the WB is 27, and this is also
  203.         in the ICON as supplied by us. If you experiment with this option
  204.         (Is there any doubt?) Remember to set it back to 27 when you are
  205.         done.
  206.         
  207.         It's a very fine tune control - you won't see a lot of difference
  208.         per step. The available range is about -1000 to 1000.
  209.         
  210.         CLI:  [ypo <height>]
  211.         WB:   YPO=height
  212.         
  213.         This option controls the severity of the overscan screen; This is
  214.         also a development option. The default, from both CLI and WB,
  215.         is 240, which is a "severe" overscan screen in vertical terms;
  216.         You can set the screen all the way back to 200, though you will miss
  217.         much of the image on many hi-res SSTV images. We don't recommend
  218.         playing with this one, in general.
  219.         
  220.         
  221.         
  222.         A final note on the WorkBench PARMS command:
  223.         
  224.         You may have noticed that there are a number of terms you
  225.         can use with the PARMS= tooltype. You can use one or more of
  226.         these terms by typing a vertical bar (found at the upper right
  227.         of your keyboard) between them:
  228.         
  229.         PARMS=version|chip|4meg
  230.          
  231.         Take a look in the supplied ICON is you'd like to see an example
  232.         of this.
  233.         
  234.         
  235.         
  236.         
  237.  
  238.  
  239.  
  240.